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APPENDIX B 

namespac Syst m.Storage 

{ 

// Executes a search across a specific type in an item context, 
public class ItemSearcher 

{ 

Constructors 
public ltemSearcher(); 

public ltemSearcher( Type targetType, ItemContext context ); 
public ltemSearcher( Type targetType, ItemContext context, 
params SearchExpressionQ filters ); 

Properties 

// The filters used to identify matching objects, 
public SearchExpressionCollection Filters {get;} 

// The ItemContext that specifies the domains that will be searched, 
public ItemContext ItemContext {get; set;} 

// The search parameter collection. 

public ParameterCollection Parameters {get;} 

// The type the searcher will operate against. For simple searches this is the type of 
// the object that will be returned, 
public Type TargetType {get; set;} 

Search Methods 

// Find objects of TargetType that satisfiy the conditions specified by Filters. Returns 
// an empty FindResult if no such objects exist, 
public FindResult FindAII(); 

public FindResult FindAII( FindOptions findOptions ); 
public FindResult FindAII( params SortOption[] sortOptions ); 

// Find any one object of TargetType that satisifies the conditions specified by Filters. 
// Returns null if no such object exists, 
public object FindOne(); 

public object FindOne( FindOptions findOptions ); 
public object FindOne( params SortOptionf] sortOptions ); 

// Find the object of TargetType that satisfies the conditions specified by Filters. 
//Throws ObjectNotFoundException if no such object was found. Throws MultipleObjects- 
// FoundException if more then one object was found, 
public object FindOnlyO; 

public object FindOnly( FindOptions findOptions ); 

// Determine if an object of TargetType that satisfies the conditions specified by 
// Filters exists, 
public bool ExistsQ; 
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// Creates an object that can be used to more efficiently execute the same search 
// repeatedly. 

public Prepar dFind Prepar Find(); 

public Prepar dFind PrepareFind( FindOptions findOpti ns ); 
public PreparedFind PrepareFind( params SortOption[] sortOptions ); 

// Retrieves the number of records that would be returned by FindAII(). 
public int GetCount(); 

// Asynchronous versions of various methods, 
public I AsyncResult BeginFindAII( AsyncCallback callback, 
object state ); 

public I AsyncResult BeginFindAII( FindOptions findOptions, 
AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindAII( SortOption[] sortOptions, 
AsyncCallback callback, 
object state ); 

public FindResult EndFindAII( lAsyncResult ar ); 

public lAsyncResult BeginFindOne( AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOne( FindOptions findOptions, 
AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOne( SortOption[] sortOptions, 
AsyncCallback callback, 
object state ); 

public object EndFindOne( lAsyncResult asyncResult ); 

public lAsyncResult BeginFindOnly( AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOnly( FindOptions findOptions, 
AsyncCallback callback, 
object state ); 

public lAsyncResult BeginFindOnly( SortOption[] sortOptions, 
AsyncCallback callback, 
object state ); 

public object EndFindOnly( lAsyncResult asyncResult ); 

public lAsyncResult BeginGetCount( AsyncCallback callback, 
object state ); 

public int EndGetCount( lAsyncResult asyncResult ); 
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public lAsyncR suit BeginExists( AsyncCallback callback, 
obj ctstat ); 

public bool EndExists( lAsyncR suit asyncResult ); 

// Options used when executing a search, 
public class FindOptions 

{ 

public FindOptionsQ; 

public FindOptions( params SortOption[] sortOptions ); 

// Specifies if delay loadable fields should be delay loaded, 
public bool DelayLoad {get; set;} 

// The number of matches that are returned, 
public int MaxResults {get; set;} 

// A collection of sort options. 

public SortOptionCollection SortOptions {get;} 

} 

// Represents a parameter name and value, 
public class Parameter 

{ 

// Initializes a Parameter object with a name and value, 
public Parameter( string name, object value ); 

// The parameter's name, 
public string Name {get;} 

// The parameter's value, 
public object Value {get; set;} 

} 

// A collection of parameter name/value pairs, 
public class ParameterCollection : ICollection 

{ 

public ParameterCollectionQ; 

public int Count {get;} 

public object this[string name] {get; set;} 

public object SyncRoot {get;} 

public void Add( Parameter parameter ); 

public Parameter Add( string name, object valu ); 
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public bool Contains( Param ter paramet r ); 
public boolC ntainsj [string nam ); 

public void C pyT ( Param ter[] array, int ind x ); 
v id IColl cti n.CopyT ( Array array, int ind x ); 

Enumerator IEnumerable.GetEnumerator(); 

public void Remove( Parameter parameter ); 
public void Remove( string name ); 

} 

// Represents a search that has been optimized for repeated execution, 
public class PreparedFind 

{ 

public ItemContext ItemContext {get;} 
public ParameterCollection Parameters {get;} 
public FindResult FindAIIQ; 
public object FindOne(); 
public object FindOnlyO; 
public bool Exists(); 

} 

// Specifies sorting options used in a search, 
public class SortOption 

{ 

// Initialize a object with default values, 
public SortOption(); 

// Initializes a SortOptions object with SearchExpression, order. 

public SortOption( SearchExpression SearchExpression, SortOrder order ); 

// A search SearchExpression that identifies the property that will be sorted, 
public SearchExpression Expression {get; set;} 

// Specifies ascending or descending sort order, 
public SortOrder Order {get; set;} 

} 

// A collection of sort option objects, 
public class SortOptionCollection : IList 

{ 

public SortOptionCollection(); 
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public S rtOption this[int index] {g t; set;} 
public int Add( S rtOpti nvalu ); 

public int Add( S arch Expression xpression, SortOrder rd r ); 
int IList. Add( object value ); 

public void Clear(); 

public bool Contains( SortOption value ); 
bool IList.Contains( object value ); 

public void CopyTo( SortOptionQ array, int index ); 
void ICollection.CopyTo( Array array, int index ); 

public int Count {get;} 

Enumerator IEnumerable.GetEnumerator(); 

public void lnsert( int index, SortOption value ); 
void IList.lnsert( int index, object value ); 

public int lndexOf( SortOption value ); 
int IList.lndexOf( object value ); 

public void Remove( SortOption value ); 
void IList.Remove( object value ); 
public void RemoveAt( int index ); 

public object SyncRoot {get;} 

} 

// Specifies the sort order using in a SortOption object, 
public enum SortOrder 

{ 

Ascending, 
Descending 

} 

} 
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